Skip to content

docs: reconcile documentation with recent CaDecon review PRs (#153–163)#164

Merged
daharoni merged 1 commit into
mainfrom
docs/reconcile-with-recent-prs
Jul 8, 2026
Merged

docs: reconcile documentation with recent CaDecon review PRs (#153–163)#164
daharoni merged 1 commit into
mainfrom
docs/reconcile-with-recent-prs

Conversation

@daharoni

@daharoni daharoni commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Documentation-only pass. I audited the repo docs (four parallel read-only audits) against everything merged during the CaDecon pre-publication review and fixed stale/wrong/missing statements. No code changes.

crates/solver/README.md (most stale — published crate README)

  • Overview rewritten: dual jsbindings/pybindings build + the full InDeCa pipeline (was "WASM-only, used by CaTune").
  • Fixed wrong constant: inner-loop convergence tolerance 1e-6 → configurable 1e-4; distinguished it from the outer shape-space convergence.
  • Rebuilt the module table (was 5 of 17 modules). Documented ConvMode/banded AR(2), the EMA + rolling-quantile baseline, the InDeCa/seed WASM FFI, the PyO3 API, the non-finite input guard, and FitMode (8-tuple over PyO3).

docs/ARCHITECTURE.md

  • Corrected counts (was "seven packages and two applications" → six built packages, four apps). Added the cadecon and admin apps and the @calab/ui/chart module; marked apps/cala + packages/cala-* as reserved (not-yet-built) scaffolding; noted CONVERGENCE_RANGES. Per-app deps verified against each package.json.

docs/CHANGELOG.md

apps/cadecon/PLAN.md

  • Convergence description rewritten to shape space (peak time + FWHM asymptote, patience/minIters, finalSelectionWindow) in both places.
  • Okabe-Ito palette (was D3 category10), removed the KernelConvergence residual axis, ConvergencePanel tabs + AsymptoteTrends, KernelDisplay degeneracy warning, shared @calab/ui/chart primitives, raster viridis + colorbar removal, BiexpResult.fit_mode, one-sample AR(2) source delay, FFI guard.

Python docs (python/README.md, docs/guides/cadecon.md)

  • BiexpFitResult field list now includes fit_mode; documented that the deconvolution/fit entry points raise ValueError on non-finite input. (The Sphinx {include} picks up the CHANGELOG edits automatically.)

packages/ui + packages/core READMEs

  • ui: description + a "Chart utilities" section (palette / colormap / axis helpers).
  • core: added CONVERGENCE_RANGES and the full wasm-adapter export list.

docs/CONTRIBUTING.md, docs/NEW_APP.md, apps/catune/README.md

  • Added the cadecon/admin workspaces + dev commands; noted @calab/ui/chart.

Heads-up (not addressed here)

Prettier-clean (format:check passes on all changed files).

🤖 Generated with Claude Code

Documentation-only pass. Audited the repo docs against the changes merged
during the CaDecon pre-publication review and fixed stale/wrong/missing
statements. No code changes.

crates/solver/README.md:
- Overview now describes the dual jsbindings/pybindings build and the full
  InDeCa pipeline (was "WASM-only, used by CaTune").
- Fixed the inner-loop convergence tolerance (1e-6 -> configurable 1e-4) and
  distinguished it from the outer shape-space convergence.
- Rebuilt the module table (was 5 of 17 modules); documented ConvMode/banded
  AR(2), the EMA + rolling-quantile baseline, the InDeCa/seed WASM FFI, the
  PyO3 API, the non-finite input guard, and FitMode (8-tuple over PyO3).

docs/ARCHITECTURE.md:
- Corrected package/app counts (was "seven packages, two applications");
  added the cadecon and admin apps and the @calab/ui/chart module; marked
  apps/cala + packages/cala-* as reserved (not-yet-built) scaffolding;
  noted CONVERGENCE_RANGES. Verified per-app deps against package.json.

docs/CHANGELOG.md:
- Added Unreleased entries for PRs #156-163 (with a note that #60-#155 were
  not recorded as they merged).

apps/cadecon/PLAN.md:
- Convergence description rewritten to shape-space (peak time + FWHM asymptote,
  patience/minIters, finalSelectionWindow) in both places it appeared.
- Okabe-Ito palette (was D3 category10), removed KernelConvergence residual
  axis, ConvergencePanel tabs + AsymptoteTrends, KernelDisplay degeneracy
  warning, shared @calab/ui/chart primitives, raster viridis + colorbar
  removal, BiexpResult fit_mode, one-sample AR(2) source delay, FFI guard.

Python docs (python/README.md, docs/guides/cadecon.md):
- BiexpFitResult field list now includes fit_mode; documented that the
  deconvolution/fit entry points raise ValueError on non-finite input.
  (The Sphinx changelog include picks up the CHANGELOG edits automatically.)

packages/ui + packages/core READMEs:
- ui: description + a Chart utilities section (palette/colormap/axis helpers).
- core: added CONVERGENCE_RANGES and the full wasm-adapter export list.

docs/CONTRIBUTING.md, docs/NEW_APP.md, apps/catune/README.md:
- Added the cadecon/admin workspaces and dev commands; noted @calab/ui/chart.

Prettier-clean.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@daharoni daharoni merged commit bd43256 into main Jul 8, 2026
6 checks passed
@daharoni daharoni deleted the docs/reconcile-with-recent-prs branch July 8, 2026 22:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant